home *** CD-ROM | disk | FTP | other *** search
/ MacUser Mac Bin 40 / MACUSER-MACBIN40A-1997-03.ISO.7z / MACUSER-MACBIN40A-1997-03.ISO / 特集⁄オンラインソフト / ゲーム＆アミューズメント / アミューズメント / Citron 1.07J⁄E / 収録XCMD説明＆サンプルスタック / XCMD⁄XFCN説明書 / Nutmeg説明書 < prev    next >
Text File  |  1996-10-20  |  7KB  |  128 lines
  1. 　Nutmeg XFCNは、全角数字を扱うためのユーティリティです。Nutmegを用いることで、全角数字と半角数字の相互変換や、全角数字を含んだテキストが数値として扱えるかどうかのチェックなどが行えます。
  2.  
  3.   Nutmeg XFCNは、落合  徹（ちゃい）が著作権を所有しています。自作のスタックなどに利用する場合は、当ドキュメントの「使用上の注意」の項を良く読んでからご使用ください。
  4.   なお、自作のスタック等にインストールする場合は、CitronをHomeスタックへインストールするか、ResEdit等のリソース関連ツールでNutmeg XFCNをコピーしてください。なお、Nutmeg XFCNはNtMgリソースを利用して動作している機能があるので、XFCNをコピーして使用する場合はCitronスタックの中のNtMgリソースも同様にコピーしてください。
  5.  
  6. 【Nutmeg XFCN】（Version 1.00      CodeWarrior Gold9使用 1996/8）
  7.  
  8. 0．更新履歴
  9. （Version 1.00      CodeWarrior Gold9使用 1996/8）
  10.   初回バージョン
  11.  
  12. 1．使い方
  13.  
  14.   以下に使い方を紹介します。
  15.  
  16.   Nutmegは以下の機能を持っています。
  17.  
  18.   ・数字の全角<->半角の相互変換
  19.   ・全角数字を含むテキストの数値チェック
  20.  
  21.   以下で個別に解説します。
  22.  
  23. −数字を全て全角にします
  24. 【形式】　Nutmeg(toZenkaku,テキスト)
  25. 【解説】
  26. 　半角数字及び全角数字を全て全角数字に変換します。他の文字はそのまま残ります。
  27. 　例）　「6月11日」→「６月１１日」
  28.  
  29. −数字を全て半角にします
  30. 【形式】　Nutmeg(toHankaku,テキスト)
  31. 【解説】
  32. 　半角数字及び全角数字を全て半角数字に変換します。他の文字はそのまま残ります。
  33. 　例）　「６月１１日」→「6月11日」
  34.  
  35. −英数字及び記号を全て全角にします
  36. 【形式】　Nutmeg(toZenKigou,テキスト)
  37. 【解説】
  38. 　英数字の他、基本的な記号（ASCIIキャラクターに存在するもの）を全角に変換します。対象外の文字はそのまま残ります。
  39. 　※変換対象となるのは、スペースと以下の文字です。
  40. 　!"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[¥]^_`abcdefghijklmnopqrstuvwxyz{|}~
  41.  
  42. −英数字及び記号を全て半角にします
  43. 【形式】　Nutmeg(toHanKigou,テキスト)
  44. 【解説】
  45. 　数字の他、基本的な記号（ASCIIキャラクターに存在するもの）を半角に変換します。対象外の文字はそのまま残ります。
  46. 　※変換対象となるのは、スペースと以下の文字です。
  47. 　!"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[¥]^_`abcdefghijklmnopqrstuvwxyz{|}~
  48.  
  49. −与えたテキストが数値のみかどうかをチェックします
  50. 【形式】　Nutmeg(CheckZenNum,テキスト)
  51. 【解説】
  52. 　HyperTalkでは is a number 演算子を用いる事で、データが数値かどうかをチェックする事ができますが、データが全角数字の場合には常に「数値ではない」と判断してしまいます。本形式でNutmegを用いることで、テキストに与えたデータが全角数字であっても半角数字であっても、それが数値であるかどうかをチェックすることができます。返される値は真偽値（true/false）あるいはemptyです。
  53. 　チェックは以下の条件で行われます。
  54. 　・０〜９の数字、ピリオド（小数点）、マイナス符号のみで構成されている
  55. 　・マイナス符号はデータ先頭以外に存在しない
  56. 　・上記２条件に従っていれば、全角と半角の文字が混在していてもよい
  57. 　これらの条件が全てクリアされれば、trueが返ります。
  58. 　テキストが空の場合はemptyが返ります。
  59.  
  60.   ここまでの使用でNutmeg呼び出し時に返される可能性のあるエラーメッセージは以下の通りです。エラーが起きた場合は、以下のリストの通り、先頭に「Error:」が付加されています。
  61.  
  62.   Error:Missing parameters  （パラメーターが無い）
  63.   Error:Unknown command!  （未知のコマンドが実行された）
  64.   Error:Operation text missing!  （処理するテキストが設定されていない）
  65.   Error:Memory allocate failed!  （HyperCardの割当メモリーが少なくて処理用バッファー割当に失敗した）
  66.  
  67. 8．XCMDバージョン
  68.  
  69.   以下の方法で、  Nutmegのバージョンを調べることができます。
  70.  
  71.     Nutmeg(XCMDVersion)
  72.  
  73.   the resultによって以下の書式のメッセージが取り出せます。
  74.  
  75.     Nutmeg XFCN Version *.** by -Chai-
  76.     Nutmeg XFCN PPCVersion *.** by -Chai-      （Power Macintoshバージョンの場合）
  77.  
  78.   ４ワード目(*.**と表わしたところ）に必ずバージョンナンバーが格納されているので、チェックする場合はそれを対象にしてください。
  79.  
  80. 9．Nutmegの使用上の注意
  81.  
  82.  Nutmeg XFCN 1996 (C) Copyright 落合  徹（ちゃい）
  83.  
  84.   当パッケージを使用してトラブルが起こった際に、本項を読んでいないといった理由は一切受け付けることはできません。内容主旨を理解したうえでご使用ください。
  85.  
  86.   再配付を行なう様な場合は許可を取ってください（店頭での配付や、他ネットでの配付も含む。有料・無料どちらの場合もお願いします）。
  87.   個人的使用、およびそれに準ずる範囲内を越えた利用の際は、次項の注意をよく理解した上で使用してください。
  88.  
  89.   当パッケージを使ったことによって生じた直接、間接の損害については、権利者および配付者は一切の責を負わないこととします。あくまで使用者の責任の範囲で運用を行なってください。
  90.  
  91. 10．XCMD/XFCNの使用上の注意
  92.  
  93.   当XCMD/XFCNの著作権その他の権利は落合  徹（ちゃい）が所有しています。無断で外部使用することを禁じます。この項の説明はstart usingなどで間接的にXCMD/XFCNを使用する場合（Citronでの利用）も、同じ扱いとします。
  94.  
  95.   Citronの登録ユーザーの方は、個人的使用、およびそれに準ずる範囲内で、自由にご使用ください。
  96.   PDSその他等で配付する場合は以下の通りとなります。いずれの場合も、配布者はCitronの登録ユーザーである必要があります。
  97.  
  98.   ･フリーウエアに収録して配付の場合は、原則として無料で許可を出します。
  99.   ･シェアウエアもしくはそれに準ずる形式の配付の場合は（あるいはフリーウエアでも有償にて配付する場合）、XCMD使用料(配付ソフト一種につき￥５０００)をいただきます。
  100.   ･業務目的で使用する場合、利益を生む配付（市販も含む）を行なう場合は別途ご相談ください。XCMD使用料およびライセンス料をいただきます。
  101.  ・収録せずに利用する場合、すなわちstart using等でCitronに収録されたXCMD/XFCNを呼び出す場合は、上３項目に該当しません（つまり、無料ですし、連絡の必要もありません）。ただし、当然ながらXCMD/XFCNを使用するソフト（配布ソフト）のユーザーがCitronの登録ユーザーである必要があります。
  102.  ・当XCMD/XFCNを収録したフリーウエア／シェアウエア（もしくはこれらに準ずる形式の配布形態）を雑誌等の媒体にて配布する場合、シェアウエアもしくはそれに準ずる形式の配付とみなして、配布ソフト作成者あるいは配布者（雑誌等の媒体）より、XCMD使用料(配付ソフト一種につき￥５０００)をいただきます。ただし、シェアウエアもしくはそれに準ずる形式の配付として既にXCMD使用料をいただいている場合は、二重に支払う必要はありません。
  103.  
  104.   連絡を取る場合は、２日〜１ヵ月の余裕をみておいてください。
  105.   無断使用が発覚した場合、賠償請求させていただくことがあります。
  106.  
  107.   どの場合もドキュメント等の目立つ場所に、以下の項目を記載してください。
  108.   文章スタイル等は変更なさってもかまいません。
  109.  
  110. ・Nutmeg XFCNの著作権その他の権利は落合  徹（ちゃい）（Nifty:QGA01617）が所有しています。
  111. ・Nutmeg XFCNを自作スタック等に使用なさりたい場合は、Nifty-Serve FMACHYPよりCitronスタックを入手し、登録した上でご利用ください。
  112. ・Nutmeg XFCNを使ったことによって生じた直接、間接の損害については、XCMD作者および配付者は一切の責を負わないこととします。あくまで使用者の責任の範囲で運用を行なってください。
  113. ・無断使用が発覚した場合、賠償請求させていただくことがあります。
  114.  
  115.   あるいは、
  116.  
  117. ・Nutmeg XFCN 1996 (C) Copyright 落合  徹（ちゃい）
  118.  
  119. 　だけでも結構です。こちらの場合、ドキュメント及びスタック等の作品のアバウト表示の両方に入れて下さい。
  120.  
  121. 動作チェック環境
  122.   漢字Talk 7.5.1,7.5.2
  123.   HyperCard 2.3J
  124.   QuickTime 2.1J,2.5E
  125.   Power Macintosh 8100/80AV,Macintosh LC630,Power Macintosh PowerBook 5300cs
  126.  
  127.   漢字Talk７以降なら、動作するものと思われます。
  128.